Commands and controls
are added to and organized with rows and sub-panels on a ribbon
panel.
You can add and rearrange the commands and controls
on a row that you use often, and you can remove those from a row
that you use infrequently. Rows are used to hold and organize commands
and controls on a ribbon panel. Along with using rows to organize
commands, you can also create drop-downs that contain multiple commands
and only take up the space of a single command. For more information
about drop-downs on ribbon panels, see
Add Drop-downs to a Ribbon Panel.
In addition to using
rows and sub-panels to organize commands, you can also use menu
separators. Menu separators are used to add space or lines between
commands and controls.
The following table describes
the properties for the Line command of Row 1 on the Home 2D - Draw
ribbon panel as they appear in the Properties pane.
Properties for the Line
Command on Row 1 of the Home 2D - Draw Ribbon Panel
|
Properties Pane Item
|
Description
|
Example
|
Name
|
Text used as the name
and label of the command button; does appear in the user interface.
NoteUse the “\n” character
sequence to represent a line break and display a command label on
more than one line. The “\n” character sequence is displayed as
a space instead of the characters “\n” after the changes to the command
are saved.
|
Line |
Button Style
|
Controls the size and
the label display of the command. The available options are Large
With Text (Vertical), Large With Text (Horizontal), SmallWithText,
or SmallWithoutText.
NoteIt is recommended
to not use the Large With Text (Horizontal) option as it takes up extra
space on the ribbon.
|
Large with Text (Vertical)
|
Group Name
|
Specifies the group name
assigned to the command that is used to control the organization
of the command on a drop-down.
|
|
Command Name
|
Text that contains the
name of the command as it appears in the Command List pane.
|
Line |
Description
|
Text used to describe
the element; does not appear in the user interface.
|
Creates straight line segments |
Extended Help File
|
Text that displays the
file name and ID for the extended tooltip that is displayed when
the cursor hovers over a toolbar or panel button.
|
|
Command Display Name
|
Text that contains the name of the command that
is related to the command.
|
LINE
|
Macro
|
The command macro. It
follows the standard macro syntax.
NoteWhen you change the
name of a macro, the name of its corresponding menu item or toolbar
button does not change. You must change a menu item or toolbar button
name by selecting it in the tree view.
|
^C^C_line |
Tags
|
Keywords associated to
a command. Tags provide an additional field to search when using the
Search field in the application menu.
|
|
KeyTip
|
Specifies the keytip
characters that can be used to access the command from the keyboard.
|
LI
|
Tooltip Title
|
Text string that controls
the title of the tooltip for the command.
|
|
Element ID
|
Tag that uniquely identifies
a command.
|
UIDU_0005 |
Small Image
|
ID string of the small-image
resource (16 × 16 bitmap). The string must include alphanumeric characters
with no punctuation other than a hyphen (-) or an underscore (_).
It can also be a user-defined bitmap. Click the […] button to open the
Select Image File dialog box.
|
RCDATA_16_LINE |
Large Image
|
ID string of the large-image
resource (32 × 32 bitmap). If the specified bitmap is not 32 × 32, the
program scales it to that size. The string must include alphanumeric
characters with no punctuation other than a hyphen (-) or an underscore
(_). It can also be a user-defined bitmap. Click the […] button to open the Select
Image File dialog box.
|
RCDATA_32_LINE |
Organize Commands and Controls
with Rows
A row, similar to a toolbar,
determines the order and position that commands and controls appear
on a ribbon panel. Rows run horizontally on a ribbon panel no matter
if the ribbon is displayed horizontally or vertically. Not all rows
might be displayed by default on a ribbon panel, the <SLIDEOUT>
element controls which rows are displayed without expanding a ribbon
panel. A down arrow to the right of a ribbon panel’s title indicates
that the ribbon panel can be expanded.
Organize Rows with Sub-panels
Sub-panels do not directly
contain commands. Instead, sub-panels are used in combination with
rows to organize commands and controls on a ribbon panel.
Organize Rows with Fold Panels
Fold panels can have buttons, toggles button, split buttons,
and drop-down buttons. Button Style must be set to Large with Text.
Fold panels can be converted to sub-panels.
To add a row to a ribbon
panel
-
- In the Customize User Interface Editor,
Customize tab, in the Customizations In <file name> pane,
click the plus sign (+) next to Ribbon to expand it.
- Click the plus sign (+) next to Panels
to expand it.
- Right-click the ribbon panel to which
you want to add a row. Click New Row.
- Click Apply.
To add a sub-panel or fold
panel to a row on a ribbon panel
-
- In the Customize User Interface Editor,
Customize tab, in the Customizations In <file name> pane,
click the plus sign (+) next to Ribbon to expand it.
- Click the plus sign (+) next to Panels
to expand it.
- Click the plus sign (+) next to the ribbon
panel where you want to add a sub-panel or fold panel.
- Create a new row for the sub-panel or
fold-panel if needed, or click the plus sign (+) next to the row
where you want to add a sub-panel or fold panel.
- Right-click the row where you want to
add a sub-panel or fold-panel. Click New Sub-Panel or New Fold Panel.
- Click Apply.
To remove a row or sub-panel
from a ribbon panel
-
- In the Customize User Interface Editor,
Customize tab, in the Customizations In <file name> pane,
click the plus sign (+) next to Ribbon to expand it.
- Click the plus sign (+) next to Panels
to expand it.
- Click the plus sign (+) next to the ribbon
panel from which you want to remove a row or sub-panel.
- Right-click the row or sub-panel that
you want to remove. Click Delete.
- Click Apply.
To reposition a row or
sub-panel on a ribbon panel
-
- In the Customize User Interface Editor,
Customize tab, in the Customizations In <file name> pane,
click the plus sign (+) next to Ribbon to expand it.
- Click the plus sign (+) next to Panels
to expand it.
- Click the plus sign (+) next to the ribbon
panel where you want to reposition a row or sub-panel.
- Drag the row or sub-panel that you want
to reposition up or down under the ribbon panel’s node. Use the
visual indicator bar to position the row above or below other rows
or sub-panels.
- Click Apply.
To add a command to a ribbon
panel
- In the Customize User Interface Editor,
Customize tab, in the Customizations In <file name> pane,
click the plus sign (+) next to Ribbon to expand it.
- Click the plus sign (+) next to Panels
to expand it.
- Click the plus sign (+) next to the ribbon
panel where you want to add a command.
- Click the plus sign (+) next to the rows,
sub-panels, or drop-downs to get to the location you want to add
a command.
- Drag a command from the Command List
pane to a row, sub-panel, or drop-down on the panel. Use the visual
indicator bar to specify the position of the command.
- In the Properties pane,
change
the properties of the command you added.
- Click Apply.
To remove a command from
a ribbon panel
-
- In the Customize User Interface Editor,
Customize tab, in the Customizations In <file name> pane,
click the plus sign (+) next to Ribbon to expand it.
- Click the plus sign (+) next to Panels
to expand it.
- Click the plus sign (+) next to the ribbon
panel where you want to remove a command.
- Click the plus sign (+) next to the rows,
sub-panels, or drop-downs to get to the location you want to remove
a command.
- Right-click the command that you want
to remove. Click Remove.
- Click Apply.
To reposition a command
on a ribbon panel
-
- In the Customize User Interface Editor,
Customize tab, in the Customizations In <file name> pane,
click the plus sign (+) next to Ribbon to expand it.
- Click the plus sign (+) next to Panels
to expand it.
- Click the plus sign (+) next to the ribbon
panel where you want to reposition a command.
- Click the plus sign (+) next to the rows,
sub-panels, or drop-downs to get to the location you want to reposition
a command.
- Drag the command to a new location. Use
the visual indicator bar to specify the position of the command.
- Click Apply.
To change the display and
behavior of commands, controls and drop-downs on a ribbon panel
- Do one of the following:
To show the label and set
the orientation of a command or drop-down on a ribbon panel
- In the Customize User Interface Editor,
Customize tab, in the Customizations In <file name> pane,
click the plus sign (+) next to Ribbon to expand it.
- Click the plus sign (+) next to Panels
to expand it.
- Click the plus sign (+) next to the ribbon
panel where you want to show the label for a command.
- Click the plus sign (+) next to the row,
sub-panel, or drop-down where you want to show the label for a command.
If you need to, continue expanding rows, sub-panels, and drop-downs
to get to the command or drop-down.
- Select the command that you want to show
its label for.
- In the Properties pane, Button Style
box, click the down arrow and select Large With Text (Vertical),
Large With Text (Horizontal), or SmallWithText.
- Click Apply.
To set the size of a command
or drop-down on a ribbon panel
- In the Customize User Interface Editor,
Customize tab, in the Customizations In <file name> pane,
click the plus sign (+) next to Ribbon to expand it.
- Click the plus sign (+) next to Panels
to expand it.
- Click the plus sign (+) next to the ribbon
panel which has the command or drop-down for which you want to set
the size.
- Click the plus sign (+) next to the row
or sub-panel that has the command or drop-down for which you want
to set the size. If you need to, continue expanding rows, sub-panels,
and drop-downs to get to the command or drop-down.
- Select the command or drop-down for which
you want to set the size.
- In the Properties pane, Button Style
box, click the down arrow and select Large With Text (Vertical),
Large With Text (Horizontal), SmallWithText, or SmallWithoutText.
- Click Apply.
To set the button and style
of a drop-down on a ribbon panel
- In the Customize User Interface Editor,
Customize tab, in the Customizations In <file name> pane,
click the plus sign (+) next to Ribbon to expand it.
- Click the plus sign (+) next to Panels
to expand it.
- Click the plus sign (+) next to the ribbon
panel where you want to change the style of a drop-down.
- Click the plus sign (+) next to the row
or sub-panel that contains the drop-down you want to change. If
you need to, continue expanding rows and sub-panels to get to the
drop-down.
- Select the drop-down that you want to
change, and update its properties in the Properties pane:
- In the Behavior box, click the down arrow
and select Drop Down Menu with Recent, Drop Down Menu, Split with
Recent, Split, or Split with Recent (Static).
- In the Split Button List Style box, click
the down arrow and select Icon, Icon and Text, and Descriptive.
- Click Apply.
CommandsCUI
Manages the customized
user interface elements in the product.
RIBBONRIBBONCLOSE
Closes the ribbon window.
